home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / rbtch180.zip / CAP2DOZ.ZIP / CAP2DOZ.DOC next >
Text File  |  1992-08-28  |  6KB  |  152 lines
  1.  
  2.                   --------------------------
  3.                   CAP2DOZ - A RBatch Utility
  4.                             to aid in local
  5.                             file posting
  6.                   --------------------------
  7.  
  8.                          Written by
  9.                       Dan Shore - SysOp
  10.                       THE SHORELINE BBS
  11.                         301-946-2771
  12.  
  13.                         Version 1.0
  14.                        August 28, 1992
  15.  
  16.                        Proud Member of
  17.                       DGS Systems Group
  18.                           (Wonder)
  19.  
  20.  
  21. What is CAP2DOZ?
  22. ----------------
  23. CAP2DOZ was initially written because I got tired of manually editing a
  24. screen capture file listing, to prepare it as a .DOZ file.  It started
  25. out just as a simple reformatter and then progressed into what it has
  26. become in version 1.0.  The program is nothing stupendous, but it does
  27. the trick and really makes preparing a .DOZ file MUCH MUCH easier.
  28. Hence, local file posting on your BBS is much easier.  Once the .DOZ
  29. file is prepared, you just fire up RBatch locally, and sit back and
  30. watch all the files get posted to your BBS automatically!
  31.  
  32.  
  33. What types of BBS Systems does CAP2DOZ work with?
  34. -------------------------------------------------
  35. So far I have tested CAP2DOZ with PCBoard and RBBS-PC systems, but it
  36. should work with any BBS that have this format of file listings:
  37.  
  38.     FILENAME.ZIP  939322  08-28-92  This is the file description.
  39.       and the exteneded file descriptions do not start at the
  40.       the left margin, and start with at least one space.
  41.  
  42.  
  43. CAP2DOZ Command Line:
  44. ---------------------
  45.  
  46.       PCB2DOZ <Input Filename> <Output Filename> <Cat Code>
  47.  
  48.       Input Filename  = Capture path/filename
  49.       Output Filename = Path/Filename.Doz
  50.       Cat Code        = Code to categorize ALL files - Optional
  51.                          If used this code will be put on ALL
  52.                          files processed from the capture file.
  53.                          The program will not prompt you for
  54.                          any filename.
  55.  
  56.       Paths are optional but will work for the input and output filenames.
  57.  
  58.  
  59. How CAP2DOZ Works:
  60. ------------------
  61. Follow these steps to use CAP2DOZ.
  62.  
  63. 1.  Call you favorite BBS to download some files, but don't forget to
  64.     capture the file listing.
  65.  
  66. 2.  Edit the captured file listing so that the first line of files
  67.     is the first file in the listing.  (ie.  Not headers like what file
  68.     directory it is, or colorized directory headers, etc.)  Also, edit
  69.     out any line that may have the "Continue (y,n,ns...)" prompt from the
  70.     page breaks that occur when listing files (you should only have one
  71.     of these if you did a file listing in continuous mode - be careful
  72.     that you do not do a continuous list on a BBS as some SysOp's get
  73.     annoyed that you don't download a file listing - Just capture the
  74.     new files listing or the ones that you are going to download).
  75.  
  76. 3.  Make sure that a copy of the UPCAT.HLP is in the same directory as
  77.     the CAP2DOZ.EXE file and then start the program with a command line
  78.     like this:
  79.  
  80.     a.    CAP2DOZ 828.DOC FILES.DOZ
  81.  
  82.                    - OR -
  83.  
  84.     b.    CAP2DOZ 828.DOC FILES.DOZ MISC
  85.  
  86.  
  87.     Step (a.) will run the program and each file that is in your captured
  88.     file listing will come up on the screen and show you the:
  89.  
  90.         1.  File description
  91.         2.  The "special" words used by CAP2DOZ
  92.         3.  The name of the file and ask you what category to use
  93.  
  94.  
  95.         ------ Special Codes ------
  96.  
  97.         EXIT   =  Exit the program
  98.         ENTER  =  Skip this file and continue
  99.           ?    =  Display Upcat.Hlp
  100.  
  101.  
  102.     Step (b.) will run the program but will only display the file count
  103.     of the number of files it has processed.  With step (b.), all the
  104.     files will have the category code of MISC.
  105.  
  106.  
  107. CAP2DOZ Requirements:
  108. ---------------------
  109. The only thing that CAP2DOZ requires is that a copy of the UPCAT.HLP
  110. file reside in the CURRENT DIRECTORY in order for the "?" feature to
  111. work.  If you do not have an UPCAT.HLP file in the current directory
  112. you will get an error message stating that it cannot find the UPCAT.HLP
  113. file.
  114.  
  115. CAP2DOZ Guarantee:
  116. ------------------
  117. What do I guarantee with CAP2DOZ....Well as the old saying goes, it is
  118. guaranteed to take up disk space and nothing more.
  119.  
  120. DISCLAIMER AND WARRANTY:
  121. ------------------------
  122. THIS PRODUCT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
  123. INCLUDING ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR
  124. PURPOSE.  THE ENTIRE RISK AS TO THE RESULTS AND PERFORMANCE OF THE
  125. PROGRAM IS ASSUMED BY YOU.  FURTHERMORE, I THE AUTHOR DO NOT WARRANT,
  126. GUARANTEE, OR MAKE ANY REPRESENTATIONS REGARDING THE USE OF OR THE
  127. RESULTS OF THE USE OF THE PROGRAM, OR THAT THE PROGRAM WILL RUN WITHOUT
  128. ERROR, AND YOU RELY ON THE PROGRAM AND RESULTS SOLELY AT YOUR OWN RISK.
  129. I THE AUTHOR CANNOT ACCEPT RESPONSIBILITY FOR SYSTEM DAMAGE, LOSS OF
  130. PROFIT, OR ANY OTHER SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
  131. RESULTING FROM THE USE OR INABILITY TO USE THIS PRODUCT.
  132.  
  133.  
  134. Finally:
  135. --------
  136.                          Dan Shore
  137.                      "THE SHORELINE BBS"
  138.                 Located in Silver Spring, MD
  139.                    12/24/9600/14.4 v.32bis
  140.                         301-946-2771
  141.                      Proud Member of the
  142.                 - DGS Systems Group (Wonder) -
  143.  
  144.                    RBBS-PC  Beta Test Site
  145.                    Proudly Running RBBS-PC
  146.              "The Best BBS Software in the World"
  147.  
  148.                  Member of the RIME Network
  149.                      Node ID = SHORLINE
  150.  
  151.  
  152.